home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 June / EnigmA AMIGA RUN 19 (1997)(G.R. Edizioni)(IT)[!][issue 1997-06][EAR-CD III].iso / recent1 / cdid2asim.readme < prev    next >
Text File  |  1997-05-21  |  8KB  |  236 lines
  1. Short:    Apply CDID-file on AsimCDFS-CDDA
  2. Author:   Thomas Aglassinger <agi@giga.or.at>
  3. Uploader: Thomas Aglassinger <agi@giga.or.at>
  4. Version:  1.3
  5. Type:     disk/cdrom
  6. Kurz:     CDID-Datei auf AsimCDFS-CDDA anwenden
  7. Requires: AsimCDFS 3.5, AmigaOS 2.x
  8.  
  9. TITLE
  10.  
  11.   cdid2asim
  12.  
  13. VERSION
  14.  
  15.   1.3
  16.  
  17. AUTHOR
  18.  
  19.   Thomas Aglassinger <agi@giga.or.at>
  20.  
  21. DESCRIPTION
  22.  
  23.   Transfers an already existing CDID-file to an Audio-CD (CDDA):
  24.   relabels the disk and renames the tracks using the information
  25.   found in the CDID-file.
  26.  
  27. SPECIAL REQUIREMENTS
  28.  
  29.   AsimCDFS 3.5, SCSI-CD-Rom with support for Audio-CDs, AmigaOS 2.x.
  30.   and CDID-files (which can be created and modified by several
  31.   CDDA-Players, like MCDPlayer and OptyCDPlayer).
  32.  
  33.   It also might work with older versions of AsimCDFS, but I didn't
  34.   test this.
  35.  
  36. AVAILABILITY
  37.  
  38.   Every Aminet-mirror, file "disk/cdrom/cdid2asim.lha"; for example
  39.   "ftp://ftp.wustl.edu/pub/aminet/disk/cdrom/cdid2asim.lha".
  40.  
  41. PRICE
  42.  
  43.   Freeware.
  44.  
  45. DISTRIBUTABILITY
  46.  
  47.   Cdid2asim is copyrighted freeware. It may be distributed freely as
  48.   long as no modifications are made to the executable and this
  49.   document. A nominal fee may be asked to cover distribution costs.
  50.  
  51.   Cdid2asim may not be used for any commercial purposes or included
  52.   with any commercial product without the written permission of the
  53.   author.
  54.  
  55. MOTIVATION
  56.  
  57.   AsimCDFS supports CDDAs is quite nifty way: You can access every
  58.   track immediatly as file. By default, they are named like "Track.1",
  59.   "Track.2" and so on. These names can be changed (from Workbench or
  60.   using AsimTunes), but this is a rather dull task.
  61.  
  62.   There already exists a large pool of CDID-files (for example,
  63.   aminet:disk/cdrom/CDIDCollection.lha), but unfortunatly, no
  64.   converter is included with AsimCDFS.
  65.  
  66. INSTALLATION
  67.  
  68.   Drag the icon anywhere you want and modify the tooltypes to fit your
  69.   needs.
  70.  
  71.   If you want to use it from CLI, make sure that stack has been set
  72.   to at least 16 KB (enter "stack 16384" in CLI).
  73.  
  74. TEMPLATE
  75.  
  76.   CDIDPATH/K,TRACKPATH/K,NOTITLE/S,NOTRACKS/S,NOBLANKS/S,
  77.   RESET/S,VERBOSE/S
  78.  
  79. USAGE
  80.  
  81.   Cdid2asim can be invoked from CLI or Workbench. The arguments
  82.   for the tooltypes are the same as for CLI.
  83.  
  84.   CDIDPATH   directory, where the CDID-files ("ID#?") are located
  85.   TRACKPATH  directory, where the "Track.#?"-files are located.
  86.              default "CD0:AIFF_Stereo"; usually, there should be no
  87.              need to change this.
  88.              NOTE: Renaming a file in one of the directories for 
  89.              different audio-formats also affects all corresponding 
  90.              files in all other directories.
  91.   NOTITLE    do not relabel disk with album-title
  92.   NOTRACKS   do not rename files with track-title
  93.   NOBLANKS   replace blanks in titles by underscores ("_")
  94.   RESET      reset title and/or tracks to defaults ("Title_Unknown"
  95.              and "Track.#?")
  96.   VERBOSE    enable verbose output
  97.  
  98.   The required CDID-file needs already to exist, and, of course,
  99.   the CDDA you want to apply the CDID-file on needs to be inserted
  100.   in your CD-Rom-drive.
  101.  
  102.   Cdid2asim does some manipulation on the original title when
  103.   converting it to a filename:
  104.   - surrounding blanks are removed
  105.   - text inside brakets is removed
  106.   - some special characters ("#?|~..") are replaced by "-"
  107.   - "/" is replaced by "\"
  108.  
  109.   If the filename is still too long, it will be cut-down to the
  110.   filesystem-maximum (30 characters for the album-title, 25 
  111.   characters for track-titles) and the last two characters will be 
  112.   "..".
  113.  
  114.   If several tracks exist with the same name or tracks don't result
  115.   in unique filenames after 25 characters, an unique filename will
  116.   be computed (extensions like ".1", ".2".. are appended).
  117.  
  118.   Of course, the original CDID-file remains unchanged during the
  119.   whole process.
  120.  
  121. EXAMPLE
  122.  
  123.   CDID-file: ID100081EC029E71
  124.     ("[xyz]" denotes comments which are not part of the CDID-file)
  125.  
  126.     Half Man Half Biscuit                        [artist]
  127.     Mc Intyre, Treadmore And Davitt              [title]
  128.     Outbreak Of Vitas Gerulaitis                 [track#1]
  129.     Prag Vec At The Melkweg                      [track#2]
  130.     Christian Rock Concert                       [track#3]
  131.     Lets Not                                     [track#4]
  132.     Yipps (My Baby Got The)                      [track#5]
  133.     Hedley Verityesque                           [track#6]
  134.     A Lilac Harry Quinn                          [track#7]
  135.     Our Tune                                     [track#8]
  136.     Girlfriend's Finished With Him               [track#9]
  137.     Everything's A.O.R.                          [track#10]
  138.  
  139.   Command call (for my machine):
  140.  
  141.     cdid2asim CDIDPATH=appl:sound/disks VERBOSE
  142.  
  143.   Program output:
  144.  
  145.     cdid2asim - apply CDID-file on AsimCDFS-CDDA (v1.3, 21.05.97)
  146.     (C) Thomas Aglassinger 1996,1997 - This is Freeware!
  147.     Rename `CD0:' to `Mc Intyre, Treadmore And..'
  148.     Rename `Track.1' to `Outbreak Of Vitas..'
  149.     Rename `Track.2' to `Prag Vec At The Melkweg'
  150.     Rename `Track.3' to `Christian Rock Concert'
  151.     Rename `Track.4' to `Lets Not'
  152.     Rename `Track.5' to `Yipps'
  153.     Rename `Track.6' to `Hedley Verityesque'
  154.     Rename `Track.7' to `A Lilac Harry Quinn'
  155.     Rename `Track.8' to `Our Tune'
  156.     Rename `Track.9' to `Girlfriend's Finished..'
  157.     Rename `Track.10' to `Everything's A.O.R.'
  158.     10 out of 10 track-titles modified
  159.  
  160.   Comments:
  161.  
  162.     For the title, "Mc Intyre, Treadmore And Davitt", the text is
  163.     reduced to fit 30 characters and ends with ".."
  164.     For track#1, "Outbreak Of Vitas Gerulaitis", the text is reduced
  165.     to fit 25 charaters and ends with "..". This still allows a
  166.     ".info" to be appended to the filename.
  167.     For track#5, "Yipps (My Baby Got The)", the text inside brakets
  168.     is removed and results in "Yipps".
  169.  
  170. PROBLEMS
  171.  
  172.   - If CLI-Version crashes, make sure that a stack of at least 16 KB 
  173.     is used (enter "stack 16384" in CLI)
  174.   - When updating the album-title (with NOTITLE not specified), 
  175.     CDDAs currently playing are interrupted. This is a feature of
  176.     AsimCDFS.
  177.   - Cdid2asim asumes that Examine() and ExNext() return the
  178.     track-sequence in correct order. This is the case for version
  179.     3.x of AsimCDFS, but if this changes in future, the filenames
  180.     won't fit the corresponding tracks anymore.
  181.   - As a feature of AsimCDFS, the usage of cdid2asim also affects
  182.     the database used by AsimTunes, but the artist-field remains
  183.     untouched.
  184.  
  185.   If, for some reason, the filenames get totally trashed, you
  186.   can repair them using the editor of AsimTunes. I needed this
  187.   once during development, when two files got identical names
  188.   (of course, this bug has been fixed meanwhile).
  189.  
  190. DISCLAIMER
  191.  
  192.   No responsibilities are taken for damaged CDs, CDROM drives, Amigas
  193.   or any other components or data involved while using cdid2asim.
  194.  
  195.   If you find any bugs, let me know.
  196.  
  197. CREDITS
  198.  
  199.   Thanks to Boris Jakubaschk for MCDPlayer; most of the SCSI-stuff
  200.   is based on his sources.
  201.  
  202. HISTORY
  203.  
  204.   Version 1.3, 21-May-1997
  205.   - now more SCSI device and unit necessary, as this information
  206.     is now obtained from the device name (usually CD0:)
  207.   - removed CLI options DEVICE and UNIT (as a result of the above)
  208.   - check, if CD drive is handled by AsimCDFS, is now performed in a
  209.     better way (scans OS-datastructures instead just checks for
  210.     existence of l:AsimCDFS)
  211.   - fixed some inconsistencies in this README.
  212.  
  213.   Version 1.2, 16-May-1997
  214.   - renamed from "DiskID2Asim" to "cdid2asim"
  215.   - increased stack to 16 KB (WB-Version could crash with smaller 
  216.     stack)
  217.   - improved track name conversion:
  218.     - non-alphanumeric characters (exept "." and "!") at end of
  219.       track names are removed
  220.     - blanks before the ".." at the end of long filenames are
  221.       removed
  222.     - double blanks are converted to a single one
  223.   - renamed option DISKIDPATH to CDIDPATH
  224.  
  225.   Version 1.1, 3-Sep-1996
  226.   - uses more sophisticated algorithm to create unique filenames
  227.   - no more insists on tracks named "Track.#?" and therefor
  228.     can be applied multiple times (if the DiskID-file has been
  229.     modified)
  230.   - removes only whole words from long names
  231.   - checks if "l:AsimCDFS" is available
  232.   - added RESET option
  233.  
  234.   Version 1.0, 2-Sep-1996
  235.   - initial release
  236.